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sj/ Woid Help 




Word Help Contents 

T o learn how to use Help, press F1 . 








Using Wqrd 

Step-toy-step ratnxtjons to hdp you compete 
your tasks 



Examples and Demos 

Visual examples and demonstr a tions to help 
you learn Word 



Reference Information 

Answers to common qu es tions; tips; and 
to terminology, c ommands , and the keyboard 



Programming with Microsoft Worcl 

Complete reference nf ormabon about the 
WordBasic macro language 

Technical Support 

Available support options so that you can get 
the most from your Microsoft product 
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WoidBasic Help 




Programming with 
uauaf Microsoft Word 

□ Word Help Contents 



WordBasic Statements and Functions 

Conventions 

Statements and Functions bv Category 
Statements and Functions Index 

More WordBasic Information 

Wfrafs New m WordBasic 
Gllatino Dynamic Dial og Soxes 
i jlinq OLE Automation with Word 
Kj jy Example ^ m WordBasic Help 
(Iterators ar ^ Predefined Bookmarks 



Frlor Messages - 
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toolbar Butto n images and Numbers 
Converting W ord Version 2 x Macros 
THfs Microso ft Wnrd Developer's Kit 
Wjifcrosoft S nlntmn Providers 
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Error Messages 



When you run a macro and an error occurs, you can get more information by pressing F1 or choosing the Help button m the 
error message box The following lists, the first for WordBasic error messages and the second for Word error messages, 
includes numbers you can use when trapping errors. For more information on error trapping, see On Error statement 

WordBasic Error Messages 

Enott Message 

5 
6 
7 

90 

1jP 

1^1 



Illegal function call 
Overflow 
Out of memory 
Subscript out of range 
Division bv zero 
Out of string soace 
2gj Inywliri array dimension 
Z4) Rwd parameter 335 
25= nm of memory fstack sbace) 
tt niflloq need? End Dialog or a push button 

m n irff^ n,Vfllfeaf:K/ex ' sts 

M ^ARF Ft SE expected 

Internal error 
5J; Rad tile name or number 
Sjj File not found 
54 gig 1 file mods 

57 npyire 170 error 

62 in mf t past end of file 

64 Rarifile name 

67 Tnn many files 

74 p ?ni?fT? »™ QSS disks 

75 °lWF' ]a error 

76 Path not found 
100 Syntax error 



Fig. 3C 
PRIOR ART 



»£a g8c 

WordBasic error 25 

Out of memory (stack space) 



There is not enough memory to perform the operation. See Frpemg up memory. 



Freeing up memory 



Use as many of the following procedures as practical to free up 
memory. After each step below, try again to complete the task. 



3fS 



To free up memory 

Do one or more of the following: 

• From the File menu, choose Save All. 

• Quit any other applications you are running. 

• Clo se all windows and panes except forthe aarygwndpw, 

■ Wye 

Rul 
vie 
Thr 

• Hid 



Active window 



3SO 



The window in which you are working. The active window contains 
the insertion point or a selection of text or graphics. The title bar in 
the active window is highlighted. 



• Quit all open appiicafcons, and ttten restart the computer. If 
applicable, disconnect network connections, and quit 
terminate-ancHtayr-fesident applications (TSRs) and any other 
utilities you usually run. 
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^ Printing Y«i Wok 

[H Print adocunent 

2 Pint mors than one copy at a tme 

21 Pri* several fiet at once 

2j Print a master document 

51 Print back to front 

(3 Pit* only odd or even page* 

II Print summary nf orroation or other docunent rforroedon 

U Print a draft of a document 

?) Tim background printng on or otf 

?) Use different paper for a section of a document 

21 Use dfferer* paper lor the first page or subsequent pages of r 

21 Createaprntfle tyOS 



Caned printing 

• if background pnnting is turned off, click Cancel 

♦ if background printing is turned on, double-click the printer 
icon 3 on the status bar. 



400 



)f you're pnnting a short document and background 
pnnting is turned on, the printer icon may not appear on the 
status bar long enough for you to click it to cancel printing: 
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Programming with 
in^unr Microsoft Word 

□ Word Hela Contents 



WordBasic Statements and Functions 

Conventions 

Statements and Functions bv Category 
Statements w nri Functions Index 

More WordBasic Information 

Whafs New in WordBasic 
treating Ovnamic Dialog Boxes 
ffonp OLE Au tomation with Word 
}5m Example s m WordBasic Help 
nppmtnrs and prpdpfinpri Bookmarks 
ffirgr Messao.es 

Tnnlbar Butt on and Numbers 

j-nm/artng W ^rrl VMWnn 2 * Macros 
ithw Microso ft Word ^/eloper's Kit 
fefi crosoft Solution Providers 
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AddAddln. AddAddln() 

□ Exaj_c_ 



AddAddln AddJnf [. Load] 
AddAddln(A7b07S [. Lou*]) 

The AddAddln statement adds a template or Word add-in library (WUL) to the list of global templates and add-ins in the 
Templates And Adchns dialog box (Templates command File menu). 

Argument _ E«ptonatiow 



Add/nt 
load 



The path and filename of the template or WLL 

Specifies whether to load the template or add-in after adding it to the list 

Ofzere) Doe* not load the template or adc4n 

1 or omitted Load* the tempiate or ado-ti 



tile AddAddlnO function behaves the same as the statement and also returns a value corresponding to the position of the 
gUbal template or add-in in the list where 1 is the first template or add-in. 2 is the second, and so on. This value maybe used 
vtifh other add-in statements and functions. 

You can use functions defined in a loaded WLL in a macro. Functions thattake no arguments maybe used ju««*e 
WordBasic statements; you can return the names of these functions using CountMocrosQ and MacroName$0- Functions 
in the WLL that take arguments must be declared using the Dedare statement 

For more information on loading global templates and addHns see Chapter 31. "Customizing ^SSSbS^ * 8 
mcrosott Word User's Guide . For more informatjon on using functions in WLLs. see Chapter 9. More WordBasic 
fg|chniques." in the Micrc.?.Qft WSJ&DSVdSBSteM 



See also 

liniments. Templates and A Hrilns Statements and Functions 

AridlnStated 

ClearAddlns 

rnuntA.ddlnsfi 

nnuntMacrosfl 

DfiieteAddln 

HPtAddlnlDn 

nat,AririlnName$n 

M^rmNameSfl 
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GetCurVaiues Example 

This example uses GetCurVaiues to retrieve the date the active document was created from the Document 
: Statistics dialog box (Summary info command. Re menu). The instructions then use date functions to calculate the 
number of days since the document was created and display a message box according to the result 

Dim dig As Documents tat is tics 

GetCurVaiues dig 

docdateS - dig. Created 

age ■ How( ) - DateVaiue< docdateS ) 
p age • Iat(age) 
\Q Select Case age 
Case 0 

MsgBom "This document is less than a day old." 
Case Is > 0 

MsgBom "This document was created" + StrS(age) + " day(s) ago." 
Case Else 

MsgBom "Check your computer's date and time." 
* End Select 

3 For an example that uses GetCurVaiues and shows how to toggle any check box see Absfl Example. 
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AMERICAN IMSTTTUTe Of PHY51C5 ♦ ♦ ♦ w 



All' and Its 
Member Saiettei 

Information 

Online journal 
Publishing Service 



AIP Journals 



Magazines. Book* 
jtl'rocccdiafs 

Publishing 
Services 

! mployment 
Jfe I nduitry 

I duration A 
student Services 



Science Policy 



History (fencer 



IN THE SPOTLIGHT 



(M. 



Physics Societies 
Announce Joint 
Venture to 
Launch Virtual 
Journals 

The American Institute of Physics (AIP) 
and the American Physical Society 
(APS) announced that the first two of a 
series of 'Virtual 1 ' journals in the 
physical sciences are set to launch in 
January, 2000. 



Physics and Chemistry 
Nobel Prizes 

Two Dutch physiasts win for their 
work toward deriving a unified 
framework for the forces in nature; a / 
Caltech chemist wins for developing* 
an urtrafast camera that captures all 
the steps of a chemical reaction. 
More detail in Physics News Update. 



Press Relsasg 

APS Division 
of Plasma 
Physics 
Employment 
Center 
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Find out more.. 



Physics Students Take a 
Stand Against Recent 
Kansas Evolution 
Decision 

The Society of Physics Students 
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<> ► 


Choose Topic 
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n ► 


Run Examples 






► 

z no 



< > Read About Examples r ■ 





Inspect / Edit 


/ 








Source Code 





y^SLO 

Access Online Reference 
Information 
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Q Newfcta by Example 



NewEra by Example introductory 

Topics 



Overview 

Before Using NewEra by Example 
How to Get Started 
Reading an Annotation 
Opening the Example Source Files 
Viewing Related Reference Material 
Running the Example 
Building the Examples Yoursetf 



/ 



lot 



Introducing NewEra by Example 



New£ra by Example documents over 40 NewEra programmmg examples using Microsoft Online Help 
and the NewEra 3.0 tods. You can read about examples, see tie* source code in tie NewEra V* ndow 
Painter and Language Editor, and run them all without ieaung the online help environment 
NewEra by Example can be useful to you. the NewEra developer, in many ways. It can be a study tool to 
help you learn the NewEra programming language and development environment because ail the 
examples are integrated wtfc the development envwonment you can see how each example was created 
in the Window Painter study the code m the Language Edtot read the reference documentation and 
study the example at runtime. 

NewEra by Example can also provide you with sample code, wtwh you can cut and pasta to use as e 
template lor begumng your own NewEra applications. 

Finally, you can use NewEra by Example to *pl^ withr the NewEra development and runtme 
environments. As you navigate around the NewEra by Example help system, you gradually acquire more 
and more familiarly with the NewEra landscape. 

Getting Around NewEra by Example 

In the NewEra by Example help system, the list wmdow shows aHof the subtopics for the example you are 
currently exammmg. The list wmdow you see at your ieft shows ail of the subtopics lor this irrtrodudory 
Qrtde. Qidtonanysubtopicinthelistwndowtoop^ 

Getting Started 

To learn how to start using NewEra by Example nght now. dick here: How to Gat Started 



Fig. f A 



Q Newfcia bf Example 



NewEra by Example Introductory 
Topics 



Overview 

Before Using NewEra by Exa 
How to Get Started 
Reading an Annotation i 
Opening the Example Souri 
Viewing Related Reference ► 
Running the Example 
Building the Examples Yours 




H.-in fiipM- INFORMIX Nt-wFraSMp 




tramming examples using Microsoft Online Help 
les. see foeir source code in the Newfra Window 
leaving the online help environment 

developer, m many ways, it can be a study tool to 
development enwonment because ail the 
tent you can see how each example was created 
Editor reed the reference documentation and 

code, which you can cut and paste to use as a 

the NewEra development and runtime 
Example help system, you gradually acquire mom 



shows att of the subtopics tor the exampieyou am 
shows ail of the subtopics for this introductory 
it here w the mam help window. 



rfakhig How to Gat Started 



Q MfMwfra bp Fxample 



NewEra by Example Introductoiy 
Topics 



Overview 

Before Using MewEra by 
How to Get Started 
Reading an Annotation 
Opening the Example Source* 
Viewing Related Reference n4 
Running the Example 
Building the Examples Yours i 
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^> NewEia by Example 



BEE 




"Njetthe number of rows tor the current displayMode: 

IF ro^Positioa > Super Tab le.getNuxnS tor edRo we (NULL) THEN} 43-2* 
LIT roePosition • ixSuperTabie: : iaatRow 
EOT IT 



nextBT :: activate() 



r 



43* 



The activate handier for the Next button. 
\2J button2w.wif - in nextBT handler for ix8utton;:activate event 



VARIABLE ofc BOOLEAN 

VARIABLE SuperTable ixSuperTabie 

VARIABLE rowPosition INTEGER 

LET SuperTable - (getVisuaiContainer 0 CAST ixSuperTabie) 
LET rotrPosition - SuperTable. getCurrRowNumO + 1 



43a 



^-Oonl do anything w/ the return status: 

LET o* - SuperTable. setCurrentCell(ro*Po3ition, ixSuperTabie: :curtentColuan)^3^ 

^etthe button stales: 

CALL (gecfindo«0 CAST exaopleSia) .reset3uperTableButtons( )) ^32. 

^how the current row position: n<d 
CALL (gecfindowO CAST example&ia) . showRowInlo ( i\ 




Fig. 4£ 
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^44 iiAEJABLE exaaplefindow exaapieiia 

CALL ixSQLCoanect: :getl2BpiicicConnectioa() .connect ("Sporw) 
n^A^LET exazspieflndov - NEW exaxnpleWinO 

CALL exaapleiindow.openO 

RITTON 



END HJLIN 



Fig. 









NewErii Language Reference 
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LET 







The LET statement assigns a value or an object reference to a variable, or else assigns a value to 
every member of a record or of an object 



Caw I: singto-variabto 

LET 



Varabb 



T 



Expression list 



a 



T 



bkb- 



HULL 



• ytrngsju 



Case II: nuMpie^ariaMe 
LET- 



MuMple-VAae)- 
Expression 




Expression 



Element 

array 

bfob 

dass 

foreign 

record 

variable 



Description 

The name of an ARRAY variable. 
The name of a BYTE or TEXT variable. 

The dass of the objectwhose member vanable is assigned values. 
The name of a FOREIGN variable. 

The name of a RECORD vanable. if no member (or if . ») is specified then 
member variables receive values. 
The name of a variable of a simple datatype. 



aff its 



Fig. 
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Expressions of NewEra: Object Expressions 



An object expression is a specification that evaluates to an object reference. You can reference 
objects through vanables. function calls, casts, or constructors. 




Rate 



recmi- 



7 



2 



Object En * www 
(MtSELFKwNUU) 



r Espies twit 



u.. 



j. 



J 



Element 

actual 
dass 

array 
dass 



Description 

Name of the actual class of the object If object 

axpress/on includes a caii to a constructor, an object of 

actuat r cfass is constructed. 

Name of an AflRAYvanable that contains areference to 

the object 

Name of a dass previously declared in the same 
module, and also the stated class of the object 
reference. 



Restrictions 

Must derive from 
stated cfass of object 
reference. 

Element must have a 
dass for its data type. 



Fig. 4 H 
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Features of the Button2 Example 



Overview of the 8uttons2 Example 
Graphical Object Summary 
Event Handler Summary 

Important Event Handlers 

aaxampieWin::start() 

3queryST.: acUvateQ 

afindST:.adivete() 

3next8T :adrveteO 

EIprevtousST adrvaieO 

3in$ert8T :activate() 

adeleteflT:; acflve»() 
J (3 applyST :: acm/ate( ) 
)y 3dearST:adrvateQ 
^ aewt8T::adiveteO 

3 sntryVVIn :: prt-heedar extension 
7 -'Z a anttyWto : dass extension 
!!"■ 3 entryMn :; pre-body ex tension 

enhancements and Van 



?0f 



BSC 




LET 



The LET statement assigns a value or an object reference to avenabie, or else assigns a value to 
every member ot a record or of an object 

Cms I. tn^HvuUi 

LET — 



. HUUL- 



C«seil: 



LET- 



Earam 



abetrectdass 



abstract class 
accelerator kev 

active set 
actual argument 
actual riass 
Aggregate function 
alias 
anchor 

ANSt-comoliant 
appearance 



Adass thatcannctbe used diredyto create objects, but that serves as a base 
dass from which to denve other dasses. See also CTnOTWrfrnfloH' 
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C \NewEia3 0\examples\buttons;>\buUon2ni 4gl 



INCLUDE "annotate. 4«Jt" 
INCLUDE SVSTD1 "ixeonn*4gh" 
INCLUDE "button2w.4gh" 



jIAIN 



UARIABLE exanpleVindov exanpiaVin 
CALL nesuex::annotata<buttone2J1ftIN> 

CALL ixSOl^nnact::g«tI»plicitConnection<>.conn«ct<'*Sport» u > 
LEI oxa«pletfindov - NEV exaaplaUinO 
CALL exajiplsWindov.opanO 



RETURN 
END MAIN 
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; MewEra Window Paintef 3 0 butlon2w wil ~ Enhanced QBE- 



rails i 



cusioMf5Tb(SuperTatie 



<custome 



Company 
Firat 

Last 
Address 

City 
Phone 



Customer Information 



<company> 



<fhame> 



<address1> 



<address2> 



|<crty: 



<phone> 



Stats 



|<sta Zip 



IbcrcbWidth 20 

Idastnam ixSitmTabte 



IdbCofwactM 

fctaiSijpwTai 

hdbpiayMode bcSiCMTrfte- 
Unafaied TRUE 
IfontBoU TRUE 
[fondtafc FALSE 
IfontNaae Ami 
[fontS bra 10 
IfontUnderine FALSE 
[fotegroundCoiil 
Ihmght 7230 
IhsipFio 

IhdpNum 0 Jl 



Fig. 4K 
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Features of the Edit Menu Example 
Overview of the Edit Menu Example 
The MAIN ( ) function 
Graphical Object Summary 
Event Handler Summary 
Important Event Handlers 



aedit1TB::focusfn() 
QedrtZTB ::focusln() 
QnonedrtCS :focusin() 
QffiotMi :acava»0 
0 cutMt:: activate () 
acopyMI ::adivatt() 
O SpastgMT:&dM»() 
adeleteMI::adNflfr() 

Extension Summary 

Important Extensions 

Sediftfn :: dass extension 
: 1 a ediNVin :: preheader extension 
a edifrtfo :: prebody extension 




Overview of Edit Menu 



This example provides a standard Edit menu to cut copy, paste, and delete text from a text box 
Features Introduced 

* Cmatmg menus and menu rtems, 

* Executing code when the user chooses a menu item. 

* Executing button drpboard functions. 

* Finding the current control in an appfeca&on. 

* Spedymg an accelerator key tar a menu item. 

* Executing code when the user enters a control 
« Enabling and disabling menu items. 

Source File Summary 
-SJedHnMgl 

Initiates* the appiicafton by creaftng the sdrfrtfa window. The MAN ( ) function of the application is tn this 
file. 

^editw.wil 

Provides awmdowwrth an edit menu and some demonstrate* tea boxes. - - 



I 



Fig. 4L- 
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Features of the Edit Menu Example 
Overview of the Edit Menu Example 
The MAIN () function 
Graphical Object Summary 
Event Handler Summary 
Important Event Handlers 

SeditlTB focusln() 

QeditZTB ::focusin() 

SnonedrtCS :foaisln() 

SsatMl -acavotcO 

3 cutMl: activate () 

OcopyMI ::adivatt() 
G 3 pasteMt:: activate () 
4} 3 deleted :: activate () 

Extension Summary 
important Extensions 

SediNVfo :: dass extension 

s '~ s : 3 ediNVfo::prefieader extension 
^ 3 edrNVfa rprebody extension 



404 



The MAIN( ) Function 



il9ditm.4gi: 



S1ZN 

V1RI1BLX 

editiH editita 

LET elttiN • Nil editVi&i) 

CALL edit 8N, open o 

retush 



Initializes the application by creatmg the edr6Mn window. M^W deines a vanebre in which to store a 
reference to the created window, creates the wmdow. end then opens the window. 
In tact the same actions could be performed without defining a vanatote as m the following example: 
Hiar 

CiLL ( Kit tdltfla i ) ) .op«& ( ) 
DID Eld 

TJietndthere is thawe only need a reference to the ediWin window to qudifythecaMtoopwO. Once 
the window is opened the wwdow can take care of rtsei. Thus, instead of capturing the referwce - 
generated by NEW in a vanatte. we use * instead to qualify the call to open ( ). 



f axtto 9d* 



H ChsckBox 



Mors text to edit 



Use ths edit msnu to cut and paste tsit from one textfaox to the 
other. Use ths button to start a text edrtor so you can pasts in ths 
editor. Tab to the checkbox and button to sse disabling of the msnu 
it sins. 



Fig. 4M 
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Features of the Edit Menu Exairole 



Overview of the Edit Menu Example 
The MAIN () function 
Graphical Object Summary 
Event Handler Summary 
Important Event Handlers 

3edit1TB::focusln() 

aedrtZTB ::focus!n() 

QnonecftCS :: focustn() 

3 sxnMI :: activate ( ) 

3 cutMi:: activate () 
£§ 3 copyMI: activate () 
: : SpastBMT activate () 
M 3 deleted :: activate () 

Extension Summary 
important Extensions 

hi 3 edrWn •• dass extension 

■ 0 edrtWin ;- preheader extension 
U 3edtWtn prebody extension 



/ 
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edrtlTB ::focustnO 


«2i editw.wrf - m edStTB handler tor ocTexfioxrtoaisin event 


VULXUU 

win edicfin • getflndoeo 






C1LL ?in.se«ditlMBs£Mbied( 3ELf ) 







LIT ediciia ■ getlinetoe { ) 
In the handler of the window, the members of the vwndcw are in scope. The members w scope rndude the 
graphical objects that you pant wrthm the wmdcw. 

In the handlers of other graphed objects, however, *e members of the window an not in scope, Vou 
have to qualify a member with a reference to the *ndow. 

Each graphical object has the geWindow() memberfundm which convententy reams a reference to 
the window. Vou can capture the reference in a local variable of the handier. 

ClLL »in.aet£ditXMBeInetoXed< TRIJt ) 
The example uses the reference to qualify** caito the se£d»emsEnabJed 0 fundwtThecatt passes 
the TRUE parameter to enable the editing menu Hems while the user is tn the text box 




EChecxBox 

More text to adit / 



[Text to sdit 



T 




Use the edit menu to cut and paste text from one tsxtbcx to the 
other. Use the button to start a text editor so you can paste tn the 
editor. Tab to the checkbox and button to see disabling of the menu 
items. 



Fig. W 
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Features of the Edit Menu Example 
Overview of the Edit Menu Example 
The MAIM () function 



Graphical Object Summary 
Event Handler Summary 
Important Event Handlers 

38drtlTB.:focusin() 

3edit2TB::focu$tn() 

3noneditC8 ::focusln() 

SexitMl ::acovate() 

3cutMI ::actrvate() 

3 copyMi* activate () 
O 3 pasteMI:: activate () 
€1 3 detaeMI:: activate () 

Extension Summaiy 
fmportant Extensions 

r : "; 3 edrrYrfn :: doss extension 
1 3 edrNVfa :: preheader extension 
3 edifvVm :: prabody extension 




edittTB :: focusln( ) 



-3l aditw.wtf - in edrt2TB handler tor aTaxtSoxlocusIn event 



VARIABLE 

via ediciin • sretilndowt) 

CALL »ia.setIdicIteasEaabied( SELF ) 



Calls *e sefidittemsfinabled ( ) function to enable ft e editing menu items when the user enters the text 
box. See also the discussion of adrtiTa.locustnn 




Text 



to edit ' PTCh 



410 

ChsckBox 



More text to edit 




Use the edrt menu to cut and paste text from one textbox to the 
other. Use the button to start a text editor so you can paste m the 
editor. Tab to the checkbox and button to see disabling of the menu 
(terns. 



Fig. 10 
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Features of the Edit Menu Example 
Overview of the Edit Menu Example 
The MAIN () function 
Graphical Object Summary 
Event Handler Summary 
Important Event Handlers 



SedillTB:: focusinQ 

3 aditZTB :: focuslnQ 

3nonedttC8 ::focusin() 

3exrtMI ::acflva»() 

3cutMT:acMEte() 

3copyMI ::acavatt() 
O a pasteMI:: activate () 
kZ- a deleteMI:: activate () 

Extension Summary 
important Extensions 

; 3 edtWn::dass extension 
: a edrfrtfo :: preheader ©(tension 
a ediNVfo :: prebody extension 




noneditC8 :: focusin( ) 



edrtw.wrf - in nonedrtCS handler for ocCheckSoclocusln event 



via edit f ia • getitndowO 

CALL vin.secCdlclceBBBf&abledt SELF ) 



Works in the same way as *e adirtTB inoisln n . but passes the FALSE parameter to disable the edrtmg 
menu items wt»ie the user is in the check box. 

Gaits the set£ditltemsEnebied ( ) function to disable the editing menu (terns when the user enters the 
check box The user cannot paste into a check box 




[T ext to edit 



BCheckBoxj 



More text to edit 



Use the edit menu to cut and paste text from one tsxtbox to the 
other Use the button to start a text editor so you can paste m the 
9d*or. Tab to the checkbox and button to see disabling of the menu 
urns. 



Fig. IP 



FUNCTION driveStockRpt ( destType SMALLINT, destName CHAR ( * ) ) RETUR 
laoo, MING VOID 
M .normal 

Since objects, in particular ixRow objects, cannot be passed 
as arguments to the report formatter, rows of fetched data will 
be unpacked into a record that matches the data types and lengths 
of elements in the fetched rows. 

} 



VARIABLE 

stockRec RECORD 
mn CHAR(15) , 
sn SMALLINT, 
sd CHAR (15) , 
sp MONEY {6, 2) , 
su CHAR(4) 
END RECORD, 



manuf act . manujnante 
stock. stock_num 
stock. description 
stock . unit_price 
stock. unit 



stockStmt ixSQLStmt, 
stmtString CHAR ( * ) , 
stockRow ixRow, 



errorCode INTEGER, 
logfile ixErrorLog 

V .normal 

Use the implicit connection object to create an SQL statement 
object. The connection object must already be connected to a 
database. 

Checking the status of the prepare ( ) call will confirm this. 

|3UO\ } . 

x { . [edit stmt} 

LET sto.ckStmt - . 
jaiS ixSQLConnect::getImplicitConnection() . creates tmtOb: ect ( ) 

Ifile stmt) 



Fig. la 
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Getting Started with Informix by Example 
Foundation.2000 
JDBC 
JDE 

Extending (Database Servers— 

ODBC 

Application Servers 
CGI Scripting 
Extra 

Creating a simple form in Visual Basic 
Create Web Applications 
_j Install ODBC and Set Up System 0SM3 

• Setup a Virtual Directory 

• Prepare .idc and .hfc Files 
Use ADO with Microsoft Visual Basic 

• Install Informix OLE OB Provider 

• Open a new Standard E>€ Project in 

• Change project name, form name, am:? 

• Add ADO library reference and ADO 
Add the data controls (ADODQ 
Add the DataGrid controls 
Prepare the code for the MSDataGridfts 

Example listing 
HrmTn I isting^ 



• 



Informix)./- 

byExample ^ 



id C rjrrirnet'it:. 




ftitf Java 
V. DataM 
Connect 
(3DBC)J 

Connsctins j 

J-nva progr, \ 
Informix s© ■. 
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Fully annotated 
Informix example* 

and HowTo 
solutions to help 

you set-up, 
understand, and 
use Informix 



Java 

Develop 

Enviror 

Connecting 
application ^ 
developed v3 

J-ava DeveM 
Environrner^ 
to an infonj 
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Fully annotated 
Informix examples 
and How-To 
solutions to help 

you set-up, 
understand, and 

use Informix 
technology- with 



Ha%, Java Database Connectivity 
(JDBC) 

Connecting your Java crogram to an Informix 
server. 



Java Development Environment 

Connecting a web application developed within a 
Java Develooment Envirorment (JDE) to an 
Informix database environment. 

Extending Database Servers 

Using and Writing DataBiade Modules. 

Open Database Connectivity 
(ODBC) 

Connecting your C program to a database server. 



Application Servers 
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Informix by Example Home 
Getting Started with Informix by Example 
Foundation.2000 

lJ Setup the Informix J/Faundaiion env« | 
U Write, deploy, and test a Java UDR 
Utilize a J»/a-based iterator routine 
S3 Create a simple user-defined type (Ul| 
d Create a UDR in an ActiveX DLL 
JDBC 

-1*5 

Generating a report «v 
; ♦ cusLdb.html |fJf< 
■ ♦ querydb.html 

♦ sportsFooter.tag 

♦ sportsHeader.tag luCK 
U Create Web applications 

d Generating detail break report* 
;U Walking through a result set 
23 Generating a report 
22 Search Informix documents 
C3 Creating a document repository 
Search for and retrieve images 
2D Write a C User Defined Routine 



Using Other Standard 
Data Blade Modules 

Writing Data Blade 
Modules 



Using the Web 
DataBlade 
Module 



Mo 



Example: Generating 
- a report using the 
Web DataBlade 
Module to query for 
data and report the 
results in HTML 
format 

How To: Create Web 
applications with the 
Web DataBlade 
Module and AppPage 
Builder. 

Example: Generating 

^^j-all Kt^=»L> ranorfc 
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Informix by Example Home 
Getting Started with Informix by Example 33 
Foundation.2000 
BUB— (*f3S 

JDE 

Extending Database Servers 
ODBC 

t Application Servers 
I CGI Scripting 
Extra 

1 Creating a simple form in Visual Basic 
I Create Web Applications 

Jj Install ODBC and Set Up System DSr- 

0 Set Up a Virtual Directory 

• Prepare .idc and .htc Res 
I Use ADO with Microsoft Visual Basic 

• Install Informix OLE DB Provider 

• Open a new Standard E>€ Project m'\s 

• Change project name, form name. am*s 

• AddADO library reference and ADO i ^ 

• Add the data controls (AOODC) 

• Add the DataGrid controls 

• Prepare the code for the MSDataGridi* 
Example Listing 
Hnw.T al istinc L ^ 



Working With 

JDBC 




Informix JDBC 
Driver 

JDBC/ODBC Bridge 

Remote JDBC 
Servers with RMI 

Other JDBC 
Examples 



itnq procedures 
rmpies illustrate 
-you can use Java 
Database Connectivity 
(JDBC) to establish a 
connection between your 
Java program and an 
Informix database server. 
The JDBC procedures and 
examples also illustrate 
how to access and 
manipulate an Informix 
database. 

You have two alternative 
APIs that you can use to 
establish a connection 
between your Java 
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Informix by Example Home jjt 
Getting Started wrth Informix by Example ^ 
Foundation.2000 
2j Set up the Informix J/Foundation envuis 
_J Write, deploy, and test a Java UDR 
22 Utilize a Java-based iterator routine n 
22 Create a simple user-defined type (U13* 
_J Create a UDR in an ActiveX DLL 
JDBC 
JDE 

Eri^^^ygja^g^^ervers 

♦ cust.db.himl 

• querydb.html 

♦ sportsFooter.tag 

• sportsHeader.tag 
_ J Create Web applications 
_j Generating detail break reports 

j Walking through a result set 
22 Generating a report 
22 Search Informix documents 
22 Creating a document repository 
22 Search for and retrieve images 
22 Write a C User Defined Routine 

.!nAridtnn fii 



Generating a Report 
Using the Web l 
Data blade Module 





Contributed by 
Erik Hennum, 
by Example Team 



ler report 
demonstrates 
to use the Web 
Data Blade module to 
query for data and report 
the results in HTML 
format. 

cust db.html 




Generating a Report Using the Web £22 
Datablade Module 

Tha customer report example demonstrates how to use the 
, . . , Web DataBlade module to query for data and report the 

results in HTML format. v 

Contributed by QUSt db.html - JSIO 
Erik Hennum, "~ j ^5 Co 

byExampie Team . , C 

This app page accepts a query and generates an HTML report 

querydb.html -isio jSof5 

This HTML page contains a form tdat invokes an app page 

sportsFooter.tag ^ jsio jgo5 

The sportsFooter dynamic tag generates the footer for an 
app page. 

sportsHeader.tag - £05 

The sportsHeader dynamic tag generates the header for an 
app page. 

%» Click here to view or print ail of the source files for this example. 



Copyright ©999 Informix Software. All Rights Reserved. 
Terms and Conditions governing the use of this website. 
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• Informix by Example Home 

• Getting Started with Informix by Example 

• Foundation.2000 
±- _j JDBC 

_j JDE 

3 _j Extending a Database Server 
= _S Generating a report 
♦ cust_db.html 



♦ sportsFooter.tag 

♦ sportsHeader.tag 
S _j Create Web applications 
3 ■■ _j Generating detail break reports 

5 1 Walking through a result set 

3- _j Generating a report 
£■ _j Search Informix documents 
£ _j Creating a document repository 
i _j Search for and retrieve images 

2 1 Manage Hierarchical Data 

3 -J Viewing an Organization Chart 

♦3 _j Writing Server Extensions 

_J ODBC 
+3 -_j Application Servers 
'ti _j CGI Scripting 

• Extra 

+3 _j Creating a simple form in Visua/Basic 



querydb.html File 



This HTML page contains a form that invokes 
instead of a CGI program to process the valu 
form. 



The sportsHeader dynamic tag creates a star 
for the HTML page as well as standard openit 

<? sportsHeadec title="Custoraer Query"> 



t As its action, the form must soecifv the Web^ 



€3 



I JK^iI till uti 
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querydb.html File 



This HTML page contains a form that invokes an app page instead of a CGI 
program to process the values in the form. 



The sportsHeader dynamic tag creates a standard header for the HTML page 
as well as standard opening text. 

<? sport5Header title-"Customer Query"> C j fjs>30 

As its action, the form must specify the Web Driver utility. 




<p> 

<FORM ACT I ON- " < ? MI VAR > $ WEB JK)M£ < ? /MI VAR" METHOD* " GET " > 



To specify the app page, the form must use a hidden input component. The 
input component must have a name of MZval and a value that's the name 
the app page. The input component below specifies the cust db.htmi app 
page. 



]|530 

•'I 



<INPUT TYPE-" HIDDEN* NAME«"MIval" VALUE- " /example s /Cus tRpt / cus tjib . html" > 
Optional state: 

<INPUT TYPE— "TEXT" NAME-" selects tat e" SIZE»"3" MAXLENGTH- " 2 "> 
<INPUT TYPE»"SUBMIT W NAME- "Submit" VALUE- " Submit " > 

</FOFM> 
</P> 



</BODY> 
</HTML> 



Copyright G999 Informix Soibimm. AM Rights ftosmad. 

forms an<3 Conditions aovwmma must of this waftsrt* 



J53S 



query db . html 



<!-- <ibyx> 
<intro> 

<pxabstract>This HTML page contains a form that invokes 
an app page</ abstract* instead of a CGI program to process 
the values in the form. 

</p> 
</intro> 
</ibyx> --> 

<!-- <ibyx> 

<p>The sportsHeader dynamic tag creates a standard header / i 
for the HTML page as well as standard opening text. ^ I 

</p> \ 
</ibyx> --> ^ 
<? sportsHeader title* "Customer Query" > 



<i-- <ibyx> 

<p>As its action, the form must specify the Web Driver utility. 
</p> 

</ibyx> --> 
<£>> 

<FORM AC^ION*"<?MIvAR>$WEBJ^OMB<?/MIVAR> l, METHOD* " GET " > 
<!-- <ibyx> 

<p>To specify the app page, the form must use a hidden input component. 
The input component must have a name of <strong>MIval</strong> and 
a value that's the name of the app page. The input component below 
specifies the <a href *"cust_db. html ">cust_ db.html</a> app page. 
</p> 

</ibyx> --> 

< INPUT TYPE* "HIDDEN" NAME-"MIval" VALUE* " / examples/ CustRpt/cust_db . html " > 
Optional state: 

<INPUT TYPE* "TEXT" NAME* "select State" SIZE»"3" MAXLENGTH* ■ 2 " > 
< INPUT TYPE* "SUBMIT" NAME* " Submit " VALUE* " Submit " > 

</FORM> 
</P> 

<?annotate> 

</BODY> 
</HTML> 
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• Getting Started wrth Informix by Example 

• Foundatton-2000 
_j JD8C 

_J JDE 

8- _j Extending a Database Server 
£ _j Generating a report 

♦ ojsLdb.html _ _ 

♦ querydb.html 

♦ sportsFootertag ^ 



S _j Create Web applications 

3s ■ i Generating detail break reports 

±) _j Walking through a result set 
5- _j Generating a report 
±- _j Search Informix documents 
t _J Creating a document repository 
± _j Search for and retneve images 
5 _j Manage Hierarchical Data 
±- _j viewing an Organization Chart 
Writing Server Extensions 
ti _j ODBC 

3 _j Application Servers 

j CGI Scnpting 

• Extra 

,+] _j Creating a simple form in Visual BasiA 



sportsHeader.tag File 

The sportsHeader dynamic tag generates the 
an app page. This tag ensures that every HT 
which it is used will have a standard header.- 1 

<«DOCTYPE HTML PUBLIC "-//03C//DTD HTML 3.2//E 

<HTML> 

<HEAD> 

<META HTTP-EQUIV=' , Content-Type'' CONTENT 3 "te 



The app page that uses this dynamic tag can> 
title as a parameter. If the title is not supplic-: 
following block sets a default title. 



j | jJUntemet 
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MIVAR Tag 



The MIVAR tag enables you to assign and display 
variables. Use variables with Web DataBlade module 
tags to dynamically generate and format the results of SQL 
statements and to process errors. 

The following table lists the mivar tag attributes. 



standard openir^ 



c Query"> 



specify the Web 



*E<?/MIVAR" METHC 



Attribute Mandatory? 



Description 



Name of the variable specified) 




s _j Wnta a c user uetined Routine 



form must use 
component mus 
that's the name < 
pa ge. The input component below specifies tj 
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when aa AppPagc calls another AppPage, Tliis 
variable is mandatory and should always be set 
to web_home, since this is the anchor variable 
anchorvar used by AppPage Builder (APB) and the Web 

DataBlade Module Administration Tool Since 
anchorvar is always set to web_home, you can 
always use heb_homc as an anchor variable in 
any AppPage. 

Specifies die directory that Webdriver uses to 
internally coordinate its interaction with the Web 
drivei dir server. The default value of tins variable is /tmp, 

This variable is only used by the Apache and CGI 
implementations of Webdriver. 

Qna/«ifi oc* til* -fill 1 rti+tmtimA «vf**1t* 1 fita tn 



® Done 
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5- l Utilize a Java-based if= 

5 2J Create a simple user- 
5 ^jCreateaUDRinanA 
_lJDBC 
_|JDE 

3 _i Extending Database Sen 
S jj Generating a report 



1 querydb.html File ^ 



<iii*^vdb| 1 1 Notepad 



B0E 



<?sport$H«adar titlas'Xustoaar Quary 1 



cust db.htmi 



sportsFooter.tag 
• sportsHeadertag 
_j Create Web 
_J Generating detail 
2J Walking through a resi 

21 Generating a report 

22 Search Informix docuri 
22 Creating a document n 

Search for and rethev 
22 Write a C User Define 
Adding 




SlS<FORM ftCTIQN*"<?HIUAR>$yEBJTOME<?/MIUAR" METHOD* "GET" > J !| 



<INPUT TVPE* "HIDDEN" NAME 2 "Hlual" UALUE* Vaxa«plas/CuatR|*s 
Optional «tat»: J 
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Getting Started with Informix by Example 
Foundation.2000 

_1 Set up the Informix J/Foundation envii^ 
_j Write, deploy, and test a JavaUDR 
_J Utilize a Java-based iterator routine 
_L] Create a simple user-defined type (Uk- : 
■_] Create a UDR in an ActiveX DLL 
JOBC 
JDE 

Extending Database Servers _ 
_j Generating a report 
• cust_db.html ^j g^j 



• sportsFooter.tag 

♦ sportsHeader.tag 
_J Create Web applications 

I Generating detail break reports 

_j Walking through a result set 
•_J Generating a report 

I Search Informix documents 

_J Creating a document repository 
_j Search for and retrieve images 
_j Write a C User Defined Routine 
i Aridinn SnunriRX supnnrj 



querydb.html File I 




This HTj 
instead! 
form. 

A 

The spoj 
for the 



htfp: //examples.! nf c*mi3ccom/cgi btfVwebckiv... ^[cj 



Date: 1999-11-10 08:22:21.000 I 



Customer Query 

Optional state: I jjl 



I 



<? 3Port5Headec t it le= "Customer Query"> 




As .its .action., the form must sDecifv the Weh 
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Informix by Example Home J 
Getting Started with Informix by Example * 
Foundation.2Q00 

_j Set up the Informix J/Foundation envii 
_J Write, deploy, and test a Java UDR 
_j Utilize a Java-based iterator routine 
_J Create a simple user-defined type (Ul 
_j Create a UDR in an ActiveX DLL 
JD8C 
JDE 

Extending Database Servers 
_j Ge y« ^|j|||| 0ft i $ 

♦ querydb.html 

♦ sportsFooter.tag 

♦ sportsHeadertag 
_j Create Web applications 

_j Generating detail break reports 
_j Walking through a result set 
_j Generating a report 
_j Search Informix documents 
•_j Creating a document repository 
_j Search for and retrieve images 
_j Write a C User Defined Routine, 
i Arirfina Snunda* sunnnrt ^ 



cust db.html File 



This ; 
repor 
gene 

The si 
forth* 

<?SPOE 
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Date: 1999-11-10 08:26:13.000 > 



Customer Report 



For state: 9 



Number (Naine|Coinpaiiy State 




l?oo _ 

Fi rstrcnyf pp uaye u i euu vnneine i d bidie vM 
to use for selecting customers in the state. IU 
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cust db.html 



<!-- <ibyx> 
<intro> 

'<p>< abstract >Thia app page accepts a query and generates an HTML 
report </abstract> in response. 

The app page uses dynamic tags to generate the header and footer for the 

HTML report. 

</$> 

fe </intro> 
</ibyx> 
<!-- <ibyx> 

<p>The sport sHeader dynamic tag creates a standard header 
for the HTML page as well as standard opening text. 

</p> 

</ibyx> --> 

<? sport sHeader title* "Customer Report "> 
< ! - - < ibyx> 

<p>First, the app page checks whether a state was specified to use for 
selecting customers in the state. If so, the block generates a 
paragraph to identify the state. 

</p> 
</ibyx> 

<?MIVAR NAME«$WHERE_STRx?/MIVAR> 

<?MIBLOCK COND- " $ (AND , $ (XST, $selectstate) , $ {<, 0, $ (STRLEN, $selectstate) ) ) "> 
<?MIVAR NAME«$WHERE_STR>WHERS State-" $selectState N <?/MIVAR> 
<?MIVARxP>For state: $selectState</Px?/MIVAR> 

<?/MIBL0CK> 

<!-- <ibyx> 

<p>Next, the app page starts the table that will contain the data. 

</p> 

</ibyx> --> 

<PxTABLE BORDER="l"> 
<TR> 

<TH>Nutnber< /THxTH>Name</THxTH>Corapany</THxTH>State< /TH> 
</TR> 

<!-- <ibyx> 

<p>The MI SQL block queries for customers, optionally selecting only customers 
from the specified state. Because the contents of the block are generated 
for every row of data, a new table row describes each customer. 

The &nbsp; HTML entity is a non-breaking space. By putting a non-breaking 
space in each column, we force the Web Browser to display the column even 
if the value is null. 
</p> 

</ibyx> - - > 

<?MISQL SQL=" SELECT customer_num, fname, lname, company, state FROM customer $WHERE_STR; 
<TR> 

<TD>$l£^sp;</TDxTD>$2^sp;$3</TD><TD>$4 </TD><TD>$5 </TD> 
</TR> 

<?/MISQL> 

</TABLEx/P> 
<!-- <ibyx> 

<p>The sportsFooter dynamic tag creates a standard footer 
for the HTML page. 

</p> 

</ibyx> --> 
<? sports Footer > 
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a- _j JD8C 

© _J JDE- 

a- J Extending a Database Server 
3- JJ Generating a report 

♦ cust_db.html 
■ ♦ querydb.html 

sportsFooter.tag 
: sportsHeader. 

S _lj Introduction 

; ♦ AppPage Overview j9*K) 

♦ Prepare Database *S 
Prepare Web DataBlade Module - 

♦ Register Web DataBlade Module 

= • Create sbspace 

■ ♦ Install AppPage Builder 

♦ Set Up AppPage Builder 

♦ Create Sample AppPage 
:tr _j Generating detail break reports 
S- _J Walking through a result set 
£f _j Generating a report 

^ 3J- _J Search Informix documents 

| Creating a document repository , 
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Creating Web 1122 
Applications with 
the Web DataBlade 
AppPage 



In this How To well build a simple Web application using a Web 
DataBlade Application Page (AppPage). This Web application will 
access an Informix database. 

Requirements: IDS 9.x, the Web DataBlade module, 
BladeManager, and a web server. BladeManager is provided 
with IDS 9.x for UNIX, NT users must install BladeManager 
from the DataBlade Development Kit (DBDK). 



These instructions assume you've already installed Informix 
IDS 9,x and have it running locally, 
«!; 



J 



"| [^Internet- 



/as 



Creating Web Applications with the Web 
DataBlade AppPage 



Woo 



f 



In this How To we'll build a simple Web application using a Web DataBlade Application Page (AppPage) This 
Web application will access an Informix database. ' 



Requirements: IDS 9.x, the Web DataBlade module, BladeManager, and a web server. BladeManager is 
provided with IDS 9.x for UNIX. NT users must install BladeManager from the DataBlade Development Kit 
(DBDK), 



These instructions assume you've already installed Informix IDS 9.x and have it running locally. 



Define a server connection and prepare a sample database. 

1. Define a server connection with setnet32 (NT). Create a sample database 
or use the stores7 demo database. 



> Prepare Database. 



2. 



Prepare the Web DataBlade development environment 
Install the Web DataBlade module and BladeManager. 



Prepare Web 
DataBlade 
Development 
Environment. 



3 Register the Web DataBlade module in the demo database with 
BladeManager 



Register the Web 
* DataBlade. 



4. Create a sbspace for smart large objects, like gifs. 



Create Smart Blob 
* Space (sbspace). 



5. Install AppPage Builder in your database. 



Install AppPage 
^ Builder in Your 
Database, 



6. Setup AppPage Builder on your web server. 



Setup AppPage 
p. Builder on Your 
Web Server. 



7. Create a sample AppPage. 



Create Sample 
* AppPage. 



8. 



Run the sample application. 

Enter the URLhttp://your_server/scripts/webdriver.exe. 



This How To has been compiled into two separate files for ease of printing. The basic file contains all of the steps 
you need to Create Web Applications with AppPage Builder, The secondary file contains additional detailed 
instructions for setting and testing database environment properties. 
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♦ Install AppPage Builder 

♦ Set Up AppPage Builder 

♦ Create Sample AppPage 
_J Generating detail break reports 

(+> | Walking through a result set 

iS- | Generating a report 

Sh __J Search Informix documents 
®- -J Creating a document repository 



3 Done 




Creating 
Applicati 
the Web 
AppPage 



: tosksfot Oegte... HBE3 



Table of Contents ~* tocher 
Introduction ITo*> 
AppPage Overview 
Prepare Database 
Prepare Web DataBlade Modi 
Register Web DataBlade Mod 
Create sbspace 
Install AppPage Builder 
Set Up AppPage Builder 
Create Sample AppPage 



iL 



[Wamjng:_Applet Window 



In this How To we'll build a simple Web application using a Web 
DataBlade Application Page (AppPage). This Web application will 
access an Informix database. 

Requirements: IDS 9.x, the Web DataBlade module, 
BladeManager, and a web server. BladeManager is provided 
with IDS 9.x for UNIX. NT users must install BladeManager 
from the DataBlade Development Kit (DBDK). 

These instructions assume you've already installed Informix 
IDS 9.x and have it running locally. 
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♦ Prepare Database 
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Create Sample AppPage 

• _j Generating detail break reports 

■ _j Walking through a result set 
■ 1 Generating a report 

■ _J Search Informix documents 
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Create Web applications (3 of 1 1) 

Introduction |3A0"*~ 

An AppPage is a special HTML templa 
HTML for presentation and Web Data 
SQL commands on the database and 
HTML 



AppPage Overview 
Prepare Database 
Prepare Web DataBlade Modi 
Register Web DataBlade Mod 
Create sbspace^jtjSO 
Install AppPage Builder 
Set Up AppPage Builder 
Create Sample AppPage 
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Warning: Applet Window 



Anyone who is comfortable coding standard HTML pages in a 
text editor will be at ease creating AppPages by hand, as 
demonstrated in this How To. 

(Informix Data Director for Web [DDW] makes creating 
AppPages even simpler. Data Director for Web 2.0, to be 
released shortly, uses an AppPage editor which is similar to the 
three-panel HTML editor used in Microsoft FrontPage. DDW 
runs on both 9.x and 7.x servers with the Ir^rr > 
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AppPage Builder provides the framework for creating AppPages 
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Informix Web Integration 
Option Overview 

Informix Web Integration Option provides high-performance 
connectivity between Web servers and Informix Dynamic 
Server . Web Integration Option enables Web developers to 
rapidly create, manage, and deploy value-added Web 
applications that dynamically deliver tailored Web pages to 
a corporation's Internet, intranet, and extranet users. 

With its openness and highly optimized integration, Web 
Integration Option enables organizations to exploit the 
power of Informix Dynamic Server while using the tools and 
languages they already know. 



Web Integration Option offers: 
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